home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ForCLI / 0Utils13.lha / 0Utils / WriteLn.doc < prev    next >
Text File  |  1995-02-21  |  1KB  |  53 lines

  1.  
  2.  
  3.     NAME
  4.     WriteLn
  5.  
  6.     SYNOPSIS
  7.     WriteLn - Write to a Filehandle - Requires v37
  8.  
  9.     INPUTS
  10.     "FILEHANDLE/N/A,NOLINE/S,TEXT/F"
  11.  
  12.     FUNCTION
  13.     WriteLn is a bit superfluous, since all U can
  14.     do with it can easily - and perhaps better -
  15.     be achieved with the use of echo and output
  16.     redirection ('>>') (expect for the case, we
  17.     try to redirect to things like CON:...).
  18.  
  19.     WriteLn just copies a string to a filehandle that
  20.     was previousy opened with 'Open'; it is part of
  21.     the archive just for completeness: if we have a
  22.     open/close/read, everyone can also expect a 'write'.
  23.     ReadLn does no checks on the given filehandle, so
  24.     it should be used carefully.
  25.  
  26.     RESULT
  27.     -/-
  28.  
  29.     NOTES
  30.     ! WriteLn is highly dangerous! Do not Use it, !
  31.     ! if U do not exactly know what U are doing!  !
  32.  
  33.     CLI - only
  34.  
  35.     should compile with SAS-C
  36.  
  37.     BUGS
  38.  
  39.     EXAMPLES
  40.     > set fh `Open T:writetest WRITE`
  41.     > WriteLn $fh This is a test
  42.     > Close $fh
  43.     > Unset fh
  44.     > cat T:writetest
  45.       This is a test
  46.  
  47.     AUTHOR
  48.     Bernd Noll, Brunnenstrasse 55, D-67661 Kaiserslautern
  49.     noll@student.uni-kl.de
  50.  
  51.  
  52.  
  53.